home *** CD-ROM | disk | FTP | other *** search
/ Merciful 2 / Merciful - Disc 2.iso / software / d / devioustools19.dms / devioustools19.adf / utils / 007.lzx / Readme.manual < prev   
Text File  |  1978-01-22  |  7KB  |  165 lines
  1. DBM IV 2.0ß  -  ESSENTIAL INFORMATION
  2. -------------------------------------
  3.  
  4. ***********
  5. *         *
  6. * PREFACE *
  7. *         *
  8. ***********
  9.  
  10.  
  11. My dear fellow Amiga lovers,
  12.  
  13.  
  14. The programm you're about to test is not an ordinary one. It's the products of
  15. three years' work. Now there is one slight problem. As you will test it, it
  16. won't seem to you as I have invested three years of work in it, though I did. I
  17. started programming the DBaseMaganer in the spring of 1993. That time, I started
  18. off (please don't laugh) in AmigaBasic. Please forgive me. Before programming it
  19. on Amiga's, a similar version was created by me for PC's. Fortunately, not long
  20. after I kicked off, HiSoft Basic appeared. So, I recoded a great deal of the
  21. programm and went on in HiSoft (which also included a compiler, a big
  22. advantage). However, HiSoft had some backdraws. It didn't give me the freedom I
  23. requered.
  24. With AMOS came the solution. I loved the AMOS editor system, including a
  25. compiler, and within months I had created a full-working system; including
  26. creating/searching/output/index facilities. Still, this was not enough. In AMOS,
  27. I used a special "library" of procedures to create WB 2.0/3.0 lookalike windows
  28. and dialog boxes. The results were quite nice, but not that fast as they should
  29. be and quite demanding, regarding memory. With AMOS_Pro, I decided not to
  30. convert the old programm, but to rewrite it entirely. Why?
  31. Firstly, I did so, because AMOS_Pro (in contrast to AMOS) has a lot of interface
  32. commands available. In AMOS I had to design things which were already, more
  33. efficiently, designed in AMOS_Pro.
  34. Secondly, after two and a half years of programming, my source code became vague
  35. and unorganised. As I never though I'd come this far, I never bothered
  36. commenting my source, nor organising it in a way I could explain myself what it
  37. did, let's say, two months after I wrote it.
  38. Thirdly, I was not quite satisfied with several formats I used for included
  39. files. I wanted less memory consumption, more speed, more flexibility and less
  40. disc space consumption. These four sometimes contradict each other and it's
  41. sometimes hard to find a compromise. I had to find new, better compromises.
  42. The programm you're about to test, is far from complete. You cannot even create
  43. a DBase. But: you can edit one (I've included an example) and you can judge the
  44. general outline and principles of the DBaseManager.
  45. I hope you will test the things you can test and write me all your comments.
  46. What went wrong? What errors did occur? What things did you like? What things
  47. did you hate? I realise testing may be a little difficult because the DBM is
  48. largely CLI structured and the HELP function is not yet implimented. Though,
  49. with the coming text, I temporarily "replace" the (yet to be implimented) help
  50. function.
  51. Please write all your comments to JBC at the X-Files BBS (070-3253901) or to
  52. jbc@dds.nl.
  53.  
  54. Thanks in advance and good luck!
  55. Jaap van den Bos, lead programmer
  56.  
  57. ********************
  58. *                  *
  59. * Acknowledgements *
  60. *                  *
  61. ********************
  62.  
  63. I wish to thank Alex van Niel for his continuing support and software supply and
  64. Fred Teunissen for his help with indexfiles and sorting them
  65.  
  66. **************
  67. *            *
  68. * Installing *
  69. *            *
  70. **************
  71.  
  72. Unpack the archive to a hard disc section (floppy disc is possible, but slows
  73. down the entiry process enormeously). Assign the device DBM: to the section
  74. containing the DBM IV 2.0ß file. Then, start it up!
  75.  
  76. *******************
  77. *                 *
  78. * General Outline *
  79. *                 *
  80. *******************
  81.  
  82. When the DBM has started up, you'll see a license window. Ignore it. Wait a few
  83. seconds and it will disappear. Then you'll see a CLI window. Typing a command
  84. will result in it's execution. The shown buttons can also be selected by "ESC"
  85. (cancel) ALT+ENTER (ok) and HELP (help) [please note that no HELP-function has
  86. been implimented yet]. All commands can be given, regardless of uppercase/
  87. lowercase. Commands are seperated by their parameters by at least one space.
  88. While running the DBM, you can switch between DBM and other programms by
  89. pressing:  [left aminga+a]. The example DBase is a DBase of my records, music
  90. casettes and CDs. Some fields have special input requirements and you will see
  91. that they don't accept certain keys, or handle them in a special way. This is
  92. normal, so don't worry. The DBM accepts special types of fields to fasciliate
  93. the storage of dates, times, yes/no switches etc. Not all of them are
  94. implimented in the example DBase.
  95.  
  96. *************
  97. *           *
  98. * Command's *
  99. *           *
  100. *************
  101.  
  102. * OPEN_DBASE
  103.  
  104. * syntax : od "name of the DBase"
  105.            open_dbase "name of the DBase"
  106.  
  107. * desciption: open DBase ???. You can now edit it, modify it etc. Only one DBase
  108. can be opened at a time. Opening a DBase will automatically close an already
  109. opened one. Omitting the parameter will result in a requester.
  110.  
  111.  
  112. * CLOSE_DBASE
  113.  
  114. * syntax : cd
  115.            close_dbase
  116.  
  117. * description: close_dbase closes the current DBase. Any information in memory
  118. buffers will be written to disc.
  119.  
  120.  
  121. * QUIT
  122.  
  123. * syntax : quit
  124.  
  125. * description: exits the programm. A CD command is performed automatically
  126.  
  127.  
  128. * EDIT_RECORD
  129.  
  130. * syntax : edit_record [parameter1][,parameter2][,parameter3] (etc)
  131.            er [parameter1][,parameter2][,parameter3] (etc)
  132.  
  133. * description: edit a record, and (on pressing OK) write the contents to the
  134. file. If necessary, index files are adapted. Pressing "ESC" will stop the entire
  135. editing procedure and the record you were editting will not be saved. It will
  136. result in going back to the DBM CLI again.
  137. [parameter] can be one of the following:
  138. 1)  rec#           : one record number, edit one record
  139. 2)  rec#1-rec#2    : edit a series of records, from rec#1 to rec#2
  140. 3)  rec#1-rec#2 s7 : as above, using "steps" of 7 records
  141. 4)  NEW            : edit new records
  142. Omitting parameters will result in a requester giving you options 1,2 and 4.
  143.  
  144.  
  145. * CHANGE FIELD
  146.  
  147. * Syntax : change_field "field#","operation"[,"new value"]
  148.            cf "field#","operation"
  149.  
  150. * description: it changes the look/characteristics of data fields in your DBase.
  151. operation can be one of the following:
  152. XC     Change the X-coordinate of the field to "new value"
  153. YC     As above, but for the Y-coordinate.
  154. INDEX  Create an indexfile, no "new value" required
  155.  
  156.  
  157. *****************
  158. *               *
  159. * Final remarks *
  160. *               *
  161. *****************
  162.  
  163. I know, I know, it's not even possible to search records... I will provide
  164. functions for it later. It's just a beta version, so you can say whether I'm on
  165. the right way or not. Please let me know.